home *** CD-ROM | disk | FTP | other *** search
/ Stone Design / Stone Design.iso / Stone_Friends / Wave / WavesWorld / Source / Libraries / tcl7.4b3 / doc / puts.n < prev    next >
Encoding:
Text File  |  1994-12-17  |  1.2 KB  |  38 lines

  1. '\"
  2. '\" Copyright (c) 1993 The Regents of the University of California.
  3. '\" Copyright (c) 1994 Sun Microsystems, Inc.
  4. '\"
  5. '\" See the file "license.terms" for information on usage and redistribution
  6. '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
  7. '\" 
  8. '\" @(#) puts.n 1.2 94/12/17 16:18:38
  9. '\" 
  10. .so man.macros
  11. .HS puts tcl
  12. .BS
  13. '\" Note:  do not modify the .SH NAME line immediately below!
  14. .SH NAME
  15. puts \- Write to a file
  16. .SH SYNOPSIS
  17. \fBputs \fR?\fB\-nonewline\fR? ?\fIfileId\fR? \fIstring\fR
  18. .BE
  19.  
  20. .SH DESCRIPTION
  21. .PP
  22. Writes the characters given by \fIstring\fR to the file given
  23. by \fIfileId\fR.
  24. \fIFileId\fR must have been the return
  25. value from a previous call to \fBopen\fR, or it may be
  26. \fBstdout\fR or \fBstderr\fR to refer to one of the standard I/O
  27. channels; it must refer to a file that was opened for
  28. writing.
  29. If no \fIfileId\fR is specified then it defaults to \fBstdout\fR.
  30. \fBPuts\fR normally outputs a newline character after \fIstring\fR,
  31. but this feature may be suppressed by specifying the \fB\-nonewline\fR
  32. switch.
  33. Output to files is buffered internally by Tcl; the \fBflush\fR
  34. command may be used to force buffered characters to be output.
  35.  
  36. .SH KEYWORDS
  37. file, newline, output, write
  38.